home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d21 / dvc15.arc / DVC.DOC < prev    next >
Text File  |  1990-11-23  |  35KB  |  924 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                             D V   C O M M A N D E R
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.        _________________________________________________________________
  25.  
  26.  
  27.  
  28.                            DV Commander version 1.5
  29.  
  30.                       A command-line utility for DESQview
  31.  
  32.                              by: William E. Allen
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.                       Copyright, 1989 by William E. Allen
  40.  
  41.                      P.O. Box 834,  Howell, Michigan  48843
  42.  
  43.  
  44.  
  45.            DV Commander version 1.5 by William E. Allen [75300,272]
  46.        Copyright 1989 by  William E. Allen, PO Box 834, Howell, MI 48843
  47.  
  48.  
  49.  
  50.  
  51.                                    SHAREWARE
  52.  
  53.        DV Commander version 1.5, is  Shareware. If you find this program
  54.        valuable and  useful, please consider  registering it by  sending
  55.        $15.00 to William E. Allen P.O. Box 834 Howell, Michigan 48843.
  56.  
  57.        Registered users  will receive a  companion program, DVP  Editor.
  58.        See the  last page of this  guide for more information  about DVP
  59.        Editor.
  60.  
  61.  
  62.                                  DISTRIBUTION
  63.  
  64.        The DV Commander program and auxiliary files are copyrighted, but
  65.        you are  hereby granted permission to  make and distribute copies
  66.        for personal, non-commercial use.  Use them yourself, give copies
  67.        to friends  and co-workers, or  distribute them for  a cost-based
  68.        fee (of  $10.00 or less)  as part of  a user's group  or bulletin
  69.        board  service.  If  you  wish  to  distribute  these programs in
  70.        connection  with  any  other  product,  or  for use in commercial
  71.        applications, please  contact me for a  license agreement. All of
  72.        the files that make up  this product must be distribute together,
  73.        in an UNMODIFIED form.
  74.  
  75.        The files you should have on the diskette, or in the archive are:
  76.  
  77.          DVC.EXE        The executable program file
  78.  
  79.          DVC.DOC        This documentation
  80.  
  81.          DVC.REG        A registration form: COPY DVC.REG PRN
  82.  
  83.  
  84.          $$-PIF.DVP     Example autostart DVP file
  85.  
  86.  
  87.          DV-PIF.DVP     Example DVP: executes DVC Menu DVUTIL
  88.  
  89.          DVUTIL.MNU     Example menu file started by QM-PIF.DVP
  90.  
  91.  
  92.          ST-PIF.DVP     Example DVP: executes DVC Start TPC
  93.  
  94.          TPC.DVP        Example DVP started by ST-PIF.DVP
  95.  
  96.          TPC.BAT        Example batch invoked by TPC.DVP
  97.  
  98.  
  99.          WHATSNEW.TXT   What's new and changed in version 1.5
  100.  
  101.  
  102.  
  103.                                   TRADEMARKS
  104.  
  105.        DESQview, DESQ,  and DESQview API  are trademarks of  Quarterdeck
  106.        Office Systems.
  107.  
  108.  
  109.  
  110.                                  INTRODUCTION
  111.  
  112.        DV  Commander is,  like a  command-line version  of your DESQview
  113.        {DESQ} key (usually your Alt key).  From the DOS command line, it
  114.        can do  many of the things  you would normally do  by tapping the
  115.        {DESQ} key.
  116.  
  117.        Among DV Commander's  features are:
  118.  
  119.          * Open a list of windows automatically
  120.  
  121.          * Start a window with prompting for parameters and directory
  122.  
  123.          * Submenu facility
  124.  
  125.          * Beep for  a  specified  frequency and  duration (useful  in a
  126.            background batch file to signal success or failure)
  127.  
  128.          * Hide or unhide (Show) a window
  129.  
  130.          * Set the window Frame on or off
  131.  
  132.          * Set Justify mode on or off
  133.  
  134.          * Wait for a specified amount of time
  135.  
  136.          * Resize and position a window
  137.  
  138.          * Make a window background or foreground
  139.  
  140.          * Name  mail boxes and check  for a named mail  box (useful for
  141.            making sure a program is started only once)
  142.  
  143.        and more.
  144.  
  145.  
  146.                                 GETTING STARTED
  147.  
  148.        To  use DV  Commander, just  copy the  file DVC.EXE  to your hard
  149.        disk. DV Commander is easiest to use when it is in a subdirectory
  150.        that is included in your PATH,  but you can specify the full path
  151.        when  you invoke  DV Commander  if its  directory is  not in your
  152.        PATH.
  153.  
  154.        Once installed, type DVC HELP to see a one-screen overview of its
  155.        commands.
  156.  
  157.  
  158.  
  159.  
  160.  
  161.                              DV Commander COMMANDS
  162.  
  163.        The format of the DV Commander command line is:
  164.  
  165.            DVC  COMMAND  <required>  [optional]  /switches
  166.  
  167.        The first word  following DVC is the COMMAND.  Some commands have
  168.        required parameters, some have optional parameters, and some have
  169.        both. Required parameters are represented in <angle brackets> and
  170.        optional parameters  are represented in  [square brackets]. There
  171.        are also a couple of switches that can be used with any command.
  172.  
  173.        Here are the DV Commander commands. The format of each command is
  174.        shown,  followed  by  a  detailed  description.  Commands  can be
  175.        entered in  upper or lower case,  but upper case letters,  at the
  176.        beginning  of  the  command  names,  are  used  here  to show the
  177.        shortest abbreviation  allowed for each  command. An ellipsis  is
  178.        used to show when parameters can be repeated.
  179.  
  180.  
  181.  
  182.        Open <dvp file name> [,nn] [,H] ...
  183.  
  184.           Use  the  Open  command  to  automatically  open  one  or more
  185.           windows. You can optionally specify  an amount of time to wait
  186.           before opening the  next window, and you can  specify that the
  187.           window be hidden after it is opened.
  188.  
  189.           This command is useful to open  a default set of windows every
  190.           time you start DESQview. To do this, set up a DVP using Change
  191.           a Program so that the program name starts with some characters
  192.           that will cause it to be  placed at the beginning of your Open
  193.           menu. Then  simply press your  Enter Key twice  after DESQview
  194.           starts and the DESQview menu  is displayed. I use "$$AutoStart
  195.           Apps" as  the program name.  Set the program  to "DVC.EXE" and
  196.           put  "OPEN  ..."  on  the  parameters  line.  See  the example
  197.           $$-PIF.DVP file on the DV Commander release disk (or archive).
  198.  
  199.           Of course you can use the DESQview LEARN facility to establish
  200.           your default  windows too, but  the LEARN facility  takes some
  201.           global memory,  and doesn't give  you the option  NOT to start
  202.           your default windows.
  203.  
  204.           Required Parameters:
  205.  
  206.           <dvp  file   name>  is  the  name   of  the  DESQview  Program
  207.             Information File. Specify  the full path for the  file if it
  208.             is  not  in  the  current  directory.  If  the DVP file name
  209.             follows  the  standard  DESQview  convention  of xx-PIF.DVP,
  210.             where  xx is  the unique  2  letter  code used  on the  Open
  211.             Program menu, you need specify only the first two letters.
  212.  
  213.           Optional Parameters:
  214.  
  215.           [,nn] is a number of 1/10th  seconds to wait after opening the
  216.             window before continuing to process the command line. nn can
  217.             be a number  in the range 1 through 3276.  A value of 1 will
  218.             delay for one  tenth of a second, while  3276 will delay for
  219.             nearly 55 minutes.
  220.  
  221.           [,H]  indicates that the window  should be  hidden after it is
  222.             opened.
  223.  
  224.           Examples:
  225.  
  226.             DVC  Open  BR,50,H  DA,H  DO
  227.  
  228.             This example will first open BR-PIF.DVP (Brief Text editor),
  229.             allow it to  run in the foreground for  5 seconds, then hide
  230.             it.  Next, DA,  the DESQview  companions date  book, will be
  231.             opened and hidden, and finally  DO, a full screen DOS shell,
  232.             will be opened and left as the foreground task.
  233.  
  234.  
  235.        Spawn  <dvpfile>  [d:\path]  [params]  [title]  [exec]  [memory]
  236.  
  237.           The Spawn command will open  a single DESQview window allowing
  238.           you to optionally override certain DVP file parameters.
  239.  
  240.           Required Parameters:
  241.  
  242.           <dvpfile>  is the  name  of  the DESQview  Program Information
  243.             File. Specify the full path for the file if it is not in the
  244.             current directory. If the DVP file name follows the standard
  245.             DESQview convention of xx-PIF.DVP, where  xx is the unique 2
  246.             letter code used on the  Open Program menu, you need specify
  247.             only the first two letters.
  248.  
  249.             NOTE: The DVP  file you start with this  command need not be
  250.             one that  you keep on  your Open Window  menu, and need  not
  251.             follow the DESQview DVP file name conventions.
  252.  
  253.           Optional Parameters:
  254.  
  255.           [d:\path] is  the drive and path  to be the default  when your
  256.             program  is started.  It will  override the  drive and  path
  257.             specified in the DVP file.
  258.  
  259.           [params] are any  program parameters you want to  pass to your
  260.             program  when  it  runs.  If  you  wish  to  pass any of the
  261.             following: Space,  Tab, Equals sign, Comma,  or Semicolon in
  262.             your parameters, enclose the  entire string in double quotes
  263.             "Like This".
  264.  
  265.           [title]  if  given  will  override  the  default  program name
  266.             specified  in  the  DVP.  It  may  be  a  string of up to 30
  267.             characters  and  must  be  enclosed  in  double quotes if it
  268.             contains any of the special characters mentioned above.
  269.  
  270.           [exec] will override the  program/execute parameter in the DVP
  271.             file.
  272.  
  273.           [memory] overrides the minimum and maximum memory requirements
  274.             specified in the DVP file.
  275.  
  276.           NOTE:  The  optional  parameters,  [d:\path]  [params] [title]
  277.           [exec]  and  [memory],  are  positional  and  they  can not be
  278.           omitted except  on the right. You  can use an asterisk  (*) to
  279.           hold the place of any parameter you do not want to specify.
  280.  
  281.           For example say you wanted to modify only the amount of memory
  282.           allocated  to  a  program  to  256k  and  leave  all the other
  283.           parameters alone  you would use  a DVC command  line something
  284.           like:
  285.  
  286.             DVC SPAWN XX  *  *  *  *  256
  287.  
  288.           where the  four asterisks hold  the places of  the: DIRECTORY,
  289.           PROGRAM PARAMETERS, TITLE, and EXECUTE parameters.
  290.  
  291.  
  292.  
  293.  
  294.        STart <dvpfile>
  295.  
  296.           The STart command  will open a single DVP  after prompting you
  297.           for, the path and parameters to be used.
  298.  
  299.           A  window like  this will  prompt you  to supply  the path and
  300.           parameters.
  301.  
  302.           +------------------------------------------------------------+
  303.           | Directory  C:\TP\WORK                                      |
  304.           |                                                            |
  305.           | Parameters WIZBANG                                         |
  306.           |                                                            |
  307.           |         F2 Save & Run       F3 Run       Esc Quit          |
  308.           +------------------------------------------------------------+
  309.  
  310.           Change  the Directory  and Parameters  fields and  press F3 to
  311.           start the DVP with the new values, or press F2 to save the new
  312.           values into the DVP and then start it. You can press ESCape to
  313.           quit without saving the new information, or starting the DVP.
  314.  
  315.           The DVP file you start with  this command would not usually be
  316.           one  that you  keep on  your Open  Window menu,  and need  not
  317.           follow the  DESQview DVP file  name conventions.  Use Change A
  318.           Program to create  the DVP and give it  some dummy value, such
  319.           as  XX for  the Keys  to Use  on Open  Menu question. Test it,
  320.           using the  normal DESQview Open  Window menu using  any values
  321.           you like for the Directory  and Parameters questions. When you
  322.           are satisfied  that it is  correct, rename it  to another name
  323.           (or copy it to another directory), and use Delete a Program to
  324.           remove it from the DESQview Open Window menu.
  325.  
  326.           NOTE: Registered  users can use  the DVP Editor  to create and
  327.                 modify the DVP which is  much easier than using Change A
  328.                 Program.
  329.  
  330.           Required Parameters:
  331.  
  332.           <dvpfile>  is the  name  of  the DESQview  Program Information
  333.             File. Specify the full path for the file if it is not in the
  334.             current directory. If the DVP file name follows the standard
  335.             DESQview convention of xx-PIF.DVP, where  xx is the unique 2
  336.             letter code used on the  Open Program menu, you need specify
  337.             only the first two letters.
  338.  
  339.  
  340.  
  341.  
  342.           Examples:
  343.  
  344.             DVC STart TPC
  345.  
  346.             This  example will  start  TPC.DVP  after prompting  for the
  347.             drive and directory and the program parameters. The TPC.DVP,
  348.             in this example, is setup as follows:
  349.  
  350.             ============================================================
  351.                                   Change a Program
  352.  
  353.             Program Name......: TP Command-Line compiler
  354.  
  355.             Keys to Use on Open Menu: XX         Memory Size (in K): 512
  356.             ------------------------------------------------------------
  357.             Program...: C:\DV\TPC.BAT
  358.             Parameters: WIZBANG
  359.             Directory.: C:\TP\WORK
  360.             ------------------------------------------------------------
  361.             Options:
  362.                       Writes text directly to screen.......: [N]
  363.                       Displays graphics information........: [N]
  364.                       Virtualize text/graphics (Y,N,T).....: [N]
  365.                       Uses serial ports (Y,N,1,2)..........: [N]
  366.                       Requires floppy diskette.............: [N]
  367.  
  368.             Press F1 for advanced options     Press <- when you are DONE
  369.             ============================================================
  370.  
  371.  
  372.             This DVP invokes a batch file, TPC.BAT, to do a Turbo Pascal
  373.             compile in the background. TPC.BAT looks like this:
  374.  
  375.                   @echo off
  376.                     cls
  377.                     DVC Hide
  378.                     C:\TP\TPC %1 %2 %3 %4 %5 %6 %7 %8 %9
  379.                     if errorlevel 1 goto Error
  380.                     DVC Beep 990,2 0,1 990,3
  381.                     exit
  382.                   :Error
  383.                     DVC Beep 330,4 180,12
  384.                     DVC Resize 1 1 23 78
  385.                     pause
  386.                     exit
  387.  
  388.  
  389.  
  390.        Menu <mnu file name>
  391.  
  392.           The  Menu command  is DV  Commander's most  useful feature. It
  393.           lets you  extend the DESQview Open  Window menu with unlimited
  394.           sub menu capabilities.
  395.  
  396.           Required Parameters:
  397.  
  398.           <mnu file name> is the only  parameter. It is the name of your
  399.             menu file and may contain a path. The file extension of .MNU
  400.             will be assumed if omitted. Each line in the file represents
  401.             one item on your sub menu. Use any pure ASCII text editor to
  402.             create  your  menu.  Each  line  in  your  menu file has the
  403.             following format.
  404.  
  405.             <description> <dvp>  [d:\path] [params] [title] [exec] [mem]
  406.  
  407.             <description>  is the  text that  will be  displayed on  the
  408.               menu.  It  should  be  enclosed  in  double  quotes  if it
  409.               contains  any  of  the  following  characters: Space, Tab,
  410.               Equals  sign, Comma,  or Semicolon.  The first  upper case
  411.               letter or  digit found in  the string will  be highlighted
  412.               and used as the selector character.
  413.  
  414.               Optionally there is a special  form of the description you
  415.               can use to  make the selector character appear  on the far
  416.               right of  the description like  DESQview's own menus.  For
  417.               example the menu line:
  418.  
  419.                 "D=DESQview Datebook"  DA
  420.  
  421.               would display in the menu as:
  422.  
  423.                 DESQview Datebook    D
  424.  
  425.               The selector character is  the first character followed by
  426.               the  equals  sign  (=)  in  the  second  position  of  the
  427.               description string.
  428.  
  429.             <dvp> is the name of  the DESQview Program Information File.
  430.               Specify the  full path for  the file if  it is not  in the
  431.               current  directory.  If  the  DVP  file  name  follows the
  432.               standard  DESQview convention  of xx-PIF.DVP,  where xx is
  433.               the unique  2 letter code  used on the  Open Program menu,
  434.               you need specify only the first two letters.
  435.  
  436.             [d:\path] is the  drive and path you want  to be the default
  437.               when your program is started.
  438.  
  439.             [params] are any program parameters you want to pass to your
  440.               program  when it  runs. If  you wish  to pass  any of  the
  441.               following: Space, Tab, Equals sign, Comma, or Semicolon in
  442.               your  parameters,  enclose  the  entire  string  in double
  443.               quotes "Like This".
  444.  
  445.  
  446.  
  447.             [title] will override the  default program name specified in
  448.               the DVP.  It may be  a string of  up to 30  characters and
  449.               must be  enclosed in double  quotes if it  contains any of
  450.               the special characters mentioned above.
  451.  
  452.             [exec]  will override  the program/execute  parameter in the
  453.               DVP file.
  454.  
  455.             [memory] overrides  the minimum and  maximum memory require-
  456.               ments specified in the DVP file.
  457.  
  458.             NOTE:  The optional  parameters, [d:\path]  [params] [title]
  459.             [exec]  and [memory],  are positional  and they  can not  be
  460.             omitted except on the right. You  can use an asterisk (*) to
  461.             hold the place of any parameter you do not want to specify.
  462.  
  463.             For  example say  you wanted  to modify  only the  amount of
  464.             memory allocated  to the program  to 128k and  leave all the
  465.             other  parameters alone  you would  use a  line in your menu
  466.             file something like:
  467.  
  468.              "D=DESQview Datebook"  DA  *  *  *  *  128
  469.  
  470.             where the four asterisks hold  the places of the: DIRECTORY,
  471.             PROGRAM PARAMETERS, TITLE, and EXECUTE parameters.
  472.  
  473.             NOTE: A new special line of the form:
  474.  
  475.               %menu "Applications Menu"
  476.  
  477.             allows you to give a name to the menu. If omitted, the title
  478.             from the DVP used to execute the DVC MENU command is used as
  479.             the menu title.
  480.  
  481.  
  482.  
  483.  
  484.           Examples:
  485.  
  486.             DVC Menu DVUTIL
  487.  
  488.             This  command will  display a  sub menu  defined in the file
  489.             DVUTIL.MNU. DVUTIL.MNU is an ASCII text file as follows:
  490.  
  491.               %menu "DV Utilities"
  492.               "C=DESQview Calculator" CA
  493.               "D=DESQview Datebook"   DA
  494.               "E=Memory Status"       MS
  495.               "F=DV Shift Install"    DVSINS
  496.               "L=DESQview Link"       DL
  497.               "M=Manifest"            MFT
  498.               "N=DESQview Note Pad"   DN
  499.               "O=Window Position"     WinPos
  500.               "P=DESQview Palette"    PL
  501.               "G=Panel Design Tool"   PD
  502.               "Q=Q Menu"              QMenu
  503.               "S=DESQview Setup"      SE
  504.               "W=QD White Papers"     QWhite
  505.  
  506.             The first item on each line is the description to display in
  507.             the menu.  The items are  enclosed in double  quotes because
  508.             they contain  spaces and/or other  special characters. There
  509.             is room on the menu to display up to 22 characters.
  510.  
  511.             Since  the  description  is  of  the  special form, with the
  512.             selector letter in the first  position followed by an equals
  513.             sign, the menu will be  displayed in the DESQview-style with
  514.             the selector characters on the far right:
  515.  
  516.               +--------------------------+
  517.               |       DV Utilities       |
  518.               |                          |
  519.               |  DESQview Calculator  C  |
  520.               |  DESQview Datebook    D  |
  521.               |  Memory Status        E  |
  522.               |  DV Shift Install     F  |
  523.               |  DESQview Link        L  |
  524.               |  Manifest             M  |
  525.               |  DESQview Note Pad    N  |
  526.               |  Window Position      O  |
  527.               |  DESQview Palette     P  |
  528.               |  Panel Design Tool    G  |
  529.               |  Q Menu               Q  |
  530.               |  DESQview Setup       S  |
  531.               |  QD White Papers      W  |
  532.               +--------------------------+
  533.  
  534.  
  535.  
  536.             You can create the DVP files  you invoke with your sub menus
  537.             using Change a Program as you usually would. Test them using
  538.             your DESQview Open Window Menu.  When you are sure the DVP's
  539.             work properly, move them to another directory and use Delete
  540.             a  Program to  remove them  from your  DESQview Open  Window
  541.             Menu.
  542.  
  543.             NOTE: Registered users can use  the DVP Editor to create and
  544.                   modify the DVP which is  much easier than using Change
  545.                   A Program.
  546.  
  547.             To  invoke your  sub menu  using the  DV Commander  program,
  548.             setup a DESQview Program Information File as follows:
  549.  
  550.             ============================================================
  551.                                   Change a Program
  552.  
  553.             Program Name......: Menu DVUTIL
  554.  
  555.             Keys to Use on Open Menu: DV         Memory Size (in K): 128
  556.             ------------------------------------------------------------
  557.             Program...: DVC.EXE
  558.             Parameters: Menu DVMENU
  559.             Directory.: C:\DV
  560.             ------------------------------------------------------------
  561.             Options:
  562.                       Writes text directly to screen.......: [N]
  563.                       Displays graphics information........: [N]
  564.                       Virtualize text/graphics (Y,N,T).....: [N]
  565.                       Uses serial ports (Y,N,1,2)..........: [N]
  566.                       Requires floppy diskette.............: [N]
  567.  
  568.             Press F1 for advanced options     Press <- when you are DONE
  569.             ============================================================
  570.                          Change a Program Advanced Options
  571.  
  572.             System Memory (in K)..: 1   Max Program Memory Size....: ___
  573.             Script Buffer Size....: 0   Max Expanded Memory Size...: ___
  574.             Text Pages: 1  Graph Pages: 0  Init Mode: ___ Ints: 00 to FF
  575.             ------------------------------------------------------------
  576.             Window Position:
  577.             Max Height:  25   Starting Height:  1   Starting Row...:   0
  578.             Max Width.:  80   Starting Width.:  1   Starting Column:  79
  579.             ------------------------------------------------------------
  580.                                   Shared Program
  581.             Pathname..:
  582.             Data......:
  583.             ------------------------------------------------------------
  584.             Close on exit.........: [Y]  Uses its own colors.......: [N]
  585.             Allow Close Window....: [Y]  Runs in background .......: [ ]
  586.             Uses math coproc......: [N]  Keyboard conflict (0-4)...: [0]
  587.             Share CPU when FG.....: [Y]  Share EGA.................: [Y]
  588.             Can be swapped out....: [ ]  Protection level (0-3)....: [0]
  589.  
  590.             Press F1 for standard options     Press <- when you are DONE
  591.             ============================================================
  592.  
  593.  
  594.  
  595.        Beep  [freq] , [duration] ... /R=n
  596.  
  597.          Use the Beep  command to generate a tone  of the specified fre-
  598.          quency and  duration. The frequency  is given in  Hertz and the
  599.          duration is in clock ticks (approximately 18 per second).
  600.  
  601.          This command is  useful in a batch file that  is running in the
  602.          background to signal success or failure. The advantage to using
  603.          this  DESQview specific  program rather  than another  utility,
  604.          like Nortons BE, is that DV  Commander uses the DESQview API to
  605.          create the sounds  and is not dependent upon  the timing of the
  606.          machine.
  607.  
  608.          Optional Parameters:
  609.  
  610.          [freq] is the frequency in Hertz. The default is 900hz.
  611.  
  612.          [duration] is the number of  clock ticks to generate the sound.
  613.            There are 18.2 clock ticks per second. The default is 7.
  614.  
  615.          Switches:
  616.  
  617.          /R=n n specifies the number of times to repeat all of the tones
  618.            given on the command line.
  619.  
  620.          Examples:
  621.  
  622.            DVC  Beep  900,1  600,1  /R=10
  623.  
  624.            This  example produces  a 900  Hertz tone  for one clock tick
  625.            (1/18th of a second) and then  a 600 Hertz tone for one clock
  626.            tick. The  entire sequence is  repeated 10 times.  The result
  627.            sounds like a telephone ringing.
  628.  
  629.  
  630.  
  631.        Hide  (no parameters)
  632.  
  633.          The Hide command will cause the  window where it is executed to
  634.          be hidden. The task will continue  to execute if it is allow to
  635.          to run in the background.
  636.  
  637.          Examples:
  638.  
  639.            DVC Hide
  640.  
  641.  
  642.  
  643.        SHow  (no parameters)
  644.  
  645.          SHow is  the opposite of the  Hide command. It will  unhide the
  646.          window in which  it is executed. This will  not make the window
  647.          suddenly pop  up on top of  the foreground window, but  it will
  648.          make it visible in the background if there are no other windows
  649.          covering it.
  650.  
  651.          Examples:
  652.  
  653.            DVC SHow
  654.  
  655.  
  656.        Frame  ON | OFF
  657.  
  658.          The  Frame command  lets you  turn the  frame on  and off for a
  659.          window.
  660.  
  661.          Examples:
  662.  
  663.            DVC Frame off
  664.  
  665.            This example will  remove the frame from the  window where it
  666.            is executed. To restore the frame type:
  667.  
  668.            DVC Frame on
  669.  
  670.  
  671.  
  672.        Justify  ON | OFF
  673.  
  674.          The Justify  command lets you set  automatic justification mode
  675.          on  or  off  for  a  window.  Normally,  with  justify mode on,
  676.          DESQview  will automatically  scroll  your  window to  keep the
  677.          hardware cursor visible. If you  set justify mode off, DESQview
  678.          will not scroll your window.
  679.  
  680.          Examples:
  681.  
  682.            DVC Justify off
  683.  
  684.  
  685.  
  686.        FOreonly ON | OFF
  687.  
  688.          The FOreonly  command lets you  select whether the  window will
  689.          run only when  it is in the foreground, or  if it will continue
  690.          to run when it is switched into the background. The default for
  691.          a given window is specified in its DVP.
  692.  
  693.          Examples:
  694.  
  695.            DVC FOreonly on
  696.  
  697.            This example will  set the window so it runs  only when it is
  698.            in the foreground. To allow it to run in the background type:
  699.  
  700.            DVC FOreonly off
  701.  
  702.  
  703.  
  704.        Name  <mail box name>
  705.  
  706.          The Name command assigns a name to the default mailbox associa-
  707.          ted with  the window where it  is executed. This is  handy when
  708.          used in  conjunction with the  /ONLYIF and /NOTIF  command line
  709.          switches  (defined later)  to  keep  from opening  a particular
  710.          window more than once.
  711.  
  712.          Required Parameters:
  713.  
  714.          <mail box name> is a name to assign to the default mail box.
  715.  
  716.          Examples:
  717.  
  718.            DVC Name Fred
  719.  
  720.            In this example DV Commander will attempt to name the default
  721.            mailbox "Fred". If  there is already a mailbox  with the same
  722.            name,  DV  Commander  will   display  an  error  message  and
  723.            terminate  with an  error code  of 1.  The error  code can be
  724.            tested in a batch file:
  725.  
  726.              DVC Name Fred
  727.              if errorlevel 1 exit
  728.              rem continue with batch file...
  729.  
  730.  
  731.        SUspend  (no parameters)
  732.  
  733.          Use the SUspend command to hide a window and suspend it so that
  734.          it does not continue to execute in the background.
  735.  
  736.          Examples:
  737.  
  738.            DVC SUspend
  739.  
  740.  
  741.        Resize  <row>, <col>, <length>, <width>
  742.  
  743.          The Resize command is used to change the location and size of a
  744.          window.
  745.  
  746.          Required Parameters:
  747.  
  748.          <row> The top  row where the window will  start. The number can
  749.            be in the range 0 through 25 which will allow you to position
  750.            part or all of the window off of the physical screen!
  751.  
  752.          <col> The left-most column where  the window will start. It can
  753.            be in the  range 0 through 80 and can  also result in part of
  754.            the window being positioned off of the physical screen.
  755.  
  756.          <length> is the new length of the window.
  757.  
  758.          <width> is the new width of the window.
  759.  
  760.          Examples:
  761.  
  762.            DVC Resize 4,17,20,60
  763.  
  764.  
  765.        Wait  [10th secs]
  766.  
  767.          The Wait command  will suspend the window where  it is executed
  768.          for the specified amount of time.
  769.  
  770.          Optional Parameters:
  771.  
  772.          [10th secs] The amount of time to wait. The default is 10 which
  773.          is one second.
  774.  
  775.  
  776.  
  777.        Goback  (no parameters)
  778.  
  779.          The Goback  command will make  the window where  it is executed
  780.          the bottommost in  the system. If the window  is the foreground
  781.          window,  the next  window in  the list  becomes the  foreground
  782.          window.
  783.  
  784.          Examples:
  785.  
  786.            DVC Goback
  787.  
  788.  
  789.  
  790.        GOFore  (no parameters)
  791.  
  792.          The GOFore  command will make  the window where  it is executed
  793.          the foreground window. Use this  command with caution as it may
  794.          disrupt the window currently running in the foreground.
  795.  
  796.          Examples:
  797.  
  798.            DVC GOFore
  799.  
  800.  
  801.        Top  (no parameters)
  802.  
  803.          This command will  make a window the top  most window within an
  804.          application. This  is of little  value since any  task that has
  805.          multiple windows  associated with it would  have to be DESQview
  806.          specific anyway.
  807.  
  808.          Examples:
  809.  
  810.            DVC Top
  811.  
  812.  
  813.  
  814.        TOPSys  (no parameters)
  815.  
  816.          The TOPSys  command makes the  window where it  is executed the
  817.          topmost window in  the system. This should only  be used when a
  818.          background application has to report  something to the user but
  819.          does not want to become the foreground window.
  820.  
  821.          Examples:
  822.  
  823.            DVC TOPSys
  824.  
  825.  
  826.                              COMMAND LINE SWITCHES
  827.  
  828.  
  829.        /C=hh
  830.  
  831.          This  command line  switch lets  you specify  the color that DV
  832.          Commander will use.  hh is the hex attribute  for the color you
  833.          want DVC  to use. It defaults  to /C=07. You must  set USES ITS
  834.          OWN COLORS to Yes if you specify this switch.
  835.  
  836.  
  837.        /Q
  838.  
  839.          Use the  "Quiet" switch to  supress and error  message windows.
  840.          Most errors will still generate messages when this switch is in
  841.          effect, but they will simply be displayed on the console rather
  842.          than pop up in a DESQview error window.
  843.  
  844.  
  845.        /ONLYIF=<mail box name>
  846.  
  847.          With this switch  in effect the DV Commander  command will only
  848.          be execute if <mail box name> exists.
  849.  
  850.  
  851.        /NOTIF=<mail box name>
  852.  
  853.          This switch  will prevent the  DV Commander command  from being
  854.          executed  if  <mail  box  name>  exists.  You  can  use this in
  855.          conjunction  with the  Name command  to prevent  a window  from
  856.          being opened more than once.
  857.  
  858.  
  859.        /R=n
  860.  
  861.          This switch is used only with  the Beep command. The number, n,
  862.          specifies the number of times the tones on the command line are
  863.          to be repeated. See the Beep command for more information.
  864.  
  865.  
  866.                                OTHER INFORMATION
  867.  
  868.        * DV Commander  has a companion  program called DVP  Editor. Like
  869.          Change  a Program,  DVP Editor  is an  editor for your DESQview
  870.          Program  Information Files.  But, unlike  CP, DVPEDIT  can edit
  871.          DVPs  with any  filename and  in any  directory. (The extension
  872.          must still be  DVP.) And, DVPEDIT does not  alter your DESQview
  873.          Open Window menu  in any way. This makes  it an ideal associate
  874.          to DV  Commander. DVPEDIT is  also nice because  it comfortably
  875.          combines  both the  standard  and  advanced options  screens of
  876.          Change a  Program into a  single easy to  edit screen, complete
  877.          with context-sensitive help for every question.
  878.  
  879.          If  you choose  to register  DV Commander,  you will  receive a
  880.          diskette containing the latest versions  of DVC and DVPEDIT and
  881.          you will receive printed documentation for both programs.
  882.  
  883.          Among DVP Editor's features are:
  884.  
  885.            * All  questions are on  one screen  * True context-sensitive
  886.            help * More logical screen layout * Edit options that are not
  887.            on  CP screen  * More  logical keyboard  usage * Edit several
  888.            DVPs  in  one  invocation  *  File  names  not  restricted to
  889.            ??-PIF.DVP * Edit  DVPs on any drive and/or  directory * Edit
  890.            DVPs that are not on the  DESQview Open menu * No ambiguities
  891.            (i.e.  no  blank  questions)  *  Runs  outside of DESQview if
  892.            desired.   * Ideal  companion  to  DV  Commander   * Free  to
  893.            registered DV Commander users
  894.  
  895.        *  DV  Commander will  use a  Microsoft compatible  mouse if  the
  896.           following two conditions are met.
  897.  
  898.           1. You have your mouse driver loaded (you already knew that!)
  899.  
  900.           2. You  have the DVP  file that starts  DVC.EXE set to  either
  901.              virtualize text when using  DESQview/386 or you have Writes
  902.              Directly  to  screen  set  to  yes,  or both. (The supplied
  903.              example DVP's have Virtualize Text=Yes).
  904.  
  905.           The reason:  Even though DV Commander  does NOT write directly
  906.           to the screen, and DOES NOT  need to be virtualized, the mouse
  907.           does.  DV Commander  checks to   see if  it is  getting direct
  908.           access  to the  screen buffer  and only  initializes the mouse
  909.           driver if so. I found that  I got "mouse droppings" when I did
  910.           not do this.
  911.  
  912.        *  If you wish to use the DV Commander Open command to open a DVP
  913.           name in the current directory  that begins with a digit, (e.g.
  914.           4D for  4DOS) you will  need to preface  it with ".\"  This is
  915.           because the command parser for the Open command will treat the
  916.           digit as a delay parameter rather  than a DVP file name. Using
  917.           the form ".\4D" (without the quotes) references the DVP in the
  918.           current directory  and works around  the problem.
  919.  
  920.        Please send  comments to: Bill Allen,  CompuServe ID [75300,272],
  921.        or at P.O. Box 834, Howell, Michigan 48843.
  922.  
  923.        Thank You.
  924.